home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / rec_110.arc / RECUSER.DOC < prev    next >
Text File  |  1991-09-10  |  9KB  |  256 lines
  1.  
  2.  
  3.                                    
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                        Remote Echo Control (REC)
  12.                              Version 1.10
  13.  
  14.                                    
  15.                           User Documentation
  16.                                    
  17.                                    
  18.                                    
  19.                                    
  20.                                    
  21.                                    
  22.          Copyrighted (c) 1990, 1991  by Daniel S. Fitch
  23.                        All Rights Reserved
  24. INTRODUCTION
  25.  
  26.      Remote Echo  Control (REC)  is a  program that allows you to
  27. remotely control  which  echos you  receive from  your echo  hub.
  28. It was  written with multiple  zones in  mind, which  is a  major
  29. limitation   in   other software  packages   that perform    this
  30. function.    This   eliminates  the manual intervention  required
  31. when   added or  deleting echos  from your feed.   Your echo  hub
  32. sysop installs  this program,  defines your  system to  REC,  and
  33. assigns you a password.  From then on, it is all up to you.
  34.  
  35.  
  36.  
  37.  
  38. USING REC
  39.  
  40.  
  41.      To use   REC,  all   you do   is send  a net-mail message to
  42. your echo  hub's system.   You  address the  message  to  "Remote
  43. Control" and  put your  password on  the subject line.  Make sure
  44. you mark the message private. You then  list the  echos you  want
  45. to   start or   stop.   After  the last  echo, you  put in  three
  46. dashes   starting in   column  1, or  "---".   This tells REC  to
  47. ignore the  rest of  the  message,  which  allows  you  to  enter
  48. comments after the dashed line.  You can put up to 50 commands in
  49. one message, any more after that will be ignored without crashing
  50. REC on your echo hub's system.
  51.  
  52.      Your echo  hub will  receive the  message and process it.  A
  53. reply message  will  be sent back to you with the results of what
  54. REC did with your message.   There  are various possible replies,
  55. which will be out-lined a little bit later.
  56.  
  57.      For this   example,  we will  assume that  you  are  already
  58. receiving 5  echos: BARONS,   SYSOP,  GAMING,  AD&D, and  SCI_FI.
  59. None of  your users  seem to   interested in  SCI_FI, but several
  60. have asked  that you  get the  echo for  Star Trek and Ham Radio.
  61. You would sent a message that would look like this:
  62.  
  63.      -SCI_FI
  64.      TREK
  65.      HAM_RADIO
  66.      ---
  67.      Add trek and Ham echos, remove Science Fictions echo.
  68.  
  69.      By putting   a  single  dash in  front of  the echo, you are
  70. telling your  echo  hub to  stop the echo.  By simply listing the
  71. echo name, you are telling  your echo  hub to  start sending  you
  72. the   echo.   The dash line, sometimes called a "tear line", just
  73. tells REC to ignore the rest of the message.
  74.  
  75.      After your echo hub receives the message, you will be sent a
  76. reply telling  you what  happened.   Such a reply might look like
  77. this:
  78.      SCI_FI............Removed     TREK..............Added
  79.      HAM_RADIO.........Added
  80.      ---
  81.      This message created by Remote Echo Control (REC) version
  82.      1.00
  83.  
  84.      That is   really  all   there is  to it.  Once you have your
  85. password, you  can   begin to start and stop your echos just this
  86. easily.  However, there are  some security  concerns that  should
  87. be  discussed  at  this point.
  88.  
  89.  
  90.  
  91.  
  92. SECURITY
  93.  
  94.  
  95.             As  I   stated before,  REC was  designed to  work in
  96. multiple zones at the same time.  As such, it will only allow you
  97. to access echos in your own zone, within your security level, and
  98. that you  have not  been locked   out  of.   However, there is an
  99. exception.
  100.  
  101.      CrossZone is  the exception  to the above rule.  If you echo
  102. hub so  chooses, you  can be  allowed to  access echos  in  other
  103. zones.   Which echos  you will  be allowed  to get  from "foreign
  104. zones" is  dependent on  the Security  and Lockout  options shown
  105. next.   These can  be used  for either CrossZone or non-CrossZone
  106. situations.
  107.  
  108.      Echo Security   and  Echo   Lockouts are   at the  option of
  109. your Echo  Hub.   Your echo hub is required to assign your system
  110. an echo  security level.     The echo  hub then has the option of
  111. assigning security  levels to individuals  echos.  If you request
  112. an echo with a required security higher than your own system, you
  113. are not allowed that echo.
  114.  
  115.      The echo   hub  can   also setup  an echo  lockout.  This is
  116. simply a  listing of   which  echos   are not  to be  sent  to  a
  117. particular system.   If  you request  an echo that you are locked
  118. out of, you will not be allowed access to the echo.
  119.  
  120.  
  121.  
  122.  
  123. REQUEST FORWARDING
  124.  
  125.  
  126.      It is   possible  that   you may  request an  echo from your
  127. echo hub  that is   not  already being received by your echo hub.
  128. At the  option of  your echo   hub,  your   request can be either
  129. denied or  accepted with  the request  also   being passed  on to
  130. the echo   hub's  feed   for that  zone. This  is called  Request
  131. Forwarding.
  132.      If this  happens, you  will receive  a reply indicating that
  133. the echo  was added   and  it   was also   forwarded.     This is
  134. important because   a  forwarded request may take longer to start
  135. entering your system.
  136.  
  137.  
  138.  
  139.  
  140. ECHO REPORTS
  141.  
  142.  
  143.      There are   two reports that you can request from REC.  They
  144. can be  sent by  themselves or  as part  of an echo request.  One
  145. report is  the Acitve  Echo   Report. This  report lists  all the
  146. echos that  are currently  being sent   to  your   system.    The
  147. second  report is the Available Echo Report.   This report  lists
  148. all  the echos currently being received by your echo hub that you
  149. are allowed to receive.
  150.  
  151.      Requesting a   report  is very easy.  You send a message off
  152. the REC  just like   you  were changing  your echos.    A  report
  153. request is indicated by a  colon, ":",  in column  1 followed  by
  154. a single  letter indicating which report  you want.   The  Active
  155. Echo Report  is the  letter "R"  and the Available echo Report is
  156. the letter "L".
  157.  
  158.  
  159.  
  160.  
  161. COMPLETE EXAMPLE
  162.  
  163.  
  164.      Below follows   a  complete example of an REC message.  This
  165. example will  show all  the possible commands, and which messages
  166. they produce.
  167.  
  168.      to: Remote Control on 1:104/435, The REC Room
  169.      fr: Dan Fitch on 1:104/453, My Test Site
  170.      re: password
  171.      
  172.      STTNG
  173.      TREK
  174.      -STINKY
  175.      :R
  176.      -APPLES
  177.      PLAY_TIME
  178.      FANTASY
  179.      -FUNKY
  180.      HACKER
  181.      TROUBLE_MAKER
  182.      ---
  183.         This is a complete example.
  184.  
  185.      The reply may look something like this:
  186.      to: Dan Fitch on 1:104/453, My Test Site
  187.      fr: Remote Control on 1:104/435, The REC Room
  188.      re: Echo Change Request
  189.      
  190.      STTNG..................Added
  191.      TREK...................Already Active
  192.      STINKY.................Removed
  193.      Report R...............Requested report follows
  194.      APPLES.................Not Active
  195.      PLAY_TIME..............Access Denied, Not in your Zone
  196.      FANTASY................Added, Request forwarded
  197.      FUNKY..................Not Processed
  198.      HACKER.................Access Denied, Invalid Security
  199.      TROUBLE_MAKER..........Access Denied, Lockout
  200.      ---
  201.      Below is a report of all echos active for 1:104/453:
  202.      
  203.      AD&D
  204.      BARONS
  205.      FANTASY
  206.      GAMING
  207.      HAM_RADIO
  208.      SYSOP
  209.      TREK
  210.      ---
  211.      This message was produced by Remote Echo Control (REC) 1.00
  212.  
  213.      The STTNG   echo  was   added without   any problem, but the
  214. TREK echo was already  being sent.   The STINKY echo is no longer
  215. being sent  down to  you.  You asked to stop the APPLES echo, but
  216. it wasn't being sent to you from  this echo  hub.   The PLAY_TIME
  217. echo was  in a  different zone  from in   which you  are located.
  218. The  FANTASY echo  was added,  but a request had  to be  sent off
  219. to the  echo hub  feed to  recieve the echo. You asked  to delete
  220. the FUNKY  echo, but  that echo  was not  found on the echo hub's
  221. system.   You didn't have enough security to get the HACKER echo,
  222. and  you are  locked out  of TROUBLE_MAKER.  A report of all your
  223. currently active echos is attached to list reply.
  224.  
  225.  
  226.  
  227.  
  228. POINT SYSTEMS
  229.  
  230.  
  231.      How a point system will be handled is up to the sysop of you
  232. echo hub.   However, you MUST be careful about one concern.  Make
  233. sure you  send the  change request  to the  correct address.  You
  234. will receive the reply from whatever address you send the request
  235. to.   If you send the request to the wrong address, your echo hub
  236. may not be able to route the reply back to you.
  237. CONCLUSION
  238.  
  239.      That is   all  there is to it.  The program is fast and easy
  240. to use,  for both   the echo  hub and the echo node.  If you have
  241. any problems or suggestions, please  send them  to your  echo hub
  242. first.   If necessary, your echo hub will forward them off to the
  243. author.
  244.  
  245.      I hope   you  enjoy   using the   program,  and find that it
  246. saves your  much time and headache in controlling your echo feed.
  247. Later!
  248.  
  249.      Dan Fitch
  250.      Author of Remote Echo Control (REC)
  251.      Sysop of The Rec Room
  252.      1:104/435@FidoNet
  253.      200:5000/211@MetroNet
  254.      Denver, Colorado
  255.      revised April 20, 1991.
  256.